DateTimeFormatter  - AS3

Имя фактического идентификатора локали, используемого этим объектом DateTimeFormatter.

В зависимости от операционной системы и значения параметра requestedLocaleIDName, передаваемого конструктору Collator(), имя может иметь одно из трех значений.

1. Если запрашиваемая локаль не является LocaleID.DEFAULT и поддерживается операционной системой, тогда возвращаемое имя совпадает со значением свойства requestedLocaleIDName.
2. Если константа LocaleID.DEFAULT использована в качестве значения параметра requestedLocaleIDName конструктора, то используется имя текущей локали, заданной в операционной системе пользователя. Значение LocaleID.DEFAULT сохраняет настройку ОС, заданную пользователем. Передача явного значения в качестве параметра requestedLocaleIDName не обязательно дает тот же результат, что использование LocaleID.DEFAULT, даже если при этом используются одинаковые имена идентификатора локали. Пользователь мог задать в своей системе пользовательские настройки локали, и запрос явного имени идентификатора локали вместо использования константы LocaleID.DEFAULT в программе не позволит извлечь эти пользовательские настройки.
3. Если система не поддерживает имя requestedLocaleIDName, определенное в конструкторе, то используется резервное имя идентификатора локали.

Связанные элементы API

Состояние предыдущей операции, которую выполнял этот объект DateTimeFormatter. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода.

Связанные элементы API

Имя запрашиваемого идентификатора локали, переданного конструктору этого объекта DateTimeFormatter.

Если использовано значение LocaleID.DEFAULT, возвращается имя i-default. Локаль, использованная на самом деле, может отличаться от запрашиваемой, когда применяется резервная локаль. Имя фактической локали можно получить с помощью свойства actualLocaleIDName.

Связанные элементы API

Создает новый объект DateTimeFormatter, чтобы отформатировать даты и время в соответствии с правилами указанной локали и заданных стилей форматирования даты и времени. Стили даты и времени служат для определения шаблонов форматирования даты и времени в соответствии с шаблонами, предварительно определенными для локали в операционной системе.

Этот конструктор определяет, поддерживает ли текущая операционная система запрашиваемое имя идентификатора локали. Если она не поддерживается, будет использована резервная локаль. Резервный идентификатор локали можно получить из свойства actualLocaleIDName.

Если для любого из параметров requestedLocaleIDName, dateStyle или timeStyle используется резервное значение, то свойство lastOperationStatus указывает тип значения по умолчанию.

Чтобы задать форматирование в соответствии с текущими пользовательскими настройками операционной системы, необходимо передать значение LocaleID.DEFAULT в параметре requestedLocaleIDName конструктора.

Когда конструктор вызывается и успешно создает объект, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

Когда запрашиваемое имя идентификатора языкового стандарта недоступно, lastOperationStatus получает одно из следующих значений:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства lastOperationStatus см. в описании класса LastOperationStatus.

Связанные элементы API

Форматирует отображаемую строку для объекта Date, который интерпретируется в соответствии с местным временем в регионе пользователя (с использованием таких компонентов местного времени объекта Date, как date, day, fullYear, hours, minutes, month и seconds). Форматирование выполняется в соответствии с правилами идентификатора локали, стилей даты и времени или на основе пользовательских шаблонов даты и времени, определенных для данного экземпляра DateTimeFormatter.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

Форматирует отображаемую строку объекта Date, который интерпретируется в соответствии с временем формата UTC (с использованием таких компонентов UTC объекта Date, как dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC и secondsUTC) и с учетом стилей dateStyle, timeStyle или шаблона даты и времени. Форматирование выполняется в соответствии с правилами идентификатора локали, стилей даты и времени или на основе пользовательских шаблонов даты и времени, определенных для данного экземпляра DateTimeFormatter.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом.

Если этот класс не поддерживается текущей операционной системой, данный метод возвращает нулевое значение.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Связанные элементы API

Получает стиль даты для данного экземпляра DateTimeFormatter. Стиль даты служит для получения шаблона форматирования даты, предварительно определенного в операционной системе. Значение стиля даты может быть задано конструктором DateTimeFormatter(), а также методом setDateTimeStyles() или setDateTimePattern().

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Связанные элементы API

Возвращает строку шаблона, используемую данным объектом DateTimeFormatter для форматирования даты и времени.

Этот шаблон можно задать одним из трех способов:

1. с помощью параметров dateStyle и timeStyle, использованных в конструкторе;
2. с помощью метода setDateTimeStyles();
3. с помощью метода setDateTimePattern().

Дополнительные сведения о синтаксисе шаблона см. в описании метода setDateTimePattern().

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Связанные элементы API

Возвращает целое число, соответствующее первому дню недели для данной локали и календарной системы. 0 обозначает воскресенье, 1— понедельник и т. д. Последнее значение 6 соответствует субботе.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Связанные элементы API

Получает список локализованных строк, содержащий названия месяцев для текущей календарной системы. Первый элемент списка содержит название первого месяца в году.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

Получает стиль времени для данного экземпляра DateTimeFormatter. Стиль времени служит для получения шаблона форматирования времени, предварительно определенного в операционной системе. Значение стиля времени может быть задано конструктором DateTimeFormatter(), а также методом setDateTimeStyles() или setDateTimePattern().

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Связанные элементы API

Получает список локализованных строк, содержащий названия дней недели для текущей календарной системы. Первый элемент списка представляет название для воскресенья.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

Определяет строку шаблона, используемую данным объектом DateTimeFormatter для форматирования даты и времени.

Шаблон для форматирования дат можно задать одним из трех способов:

1. с помощью параметров dateStyle и timeStyle, использованных в конструкторе;
2. с помощью метода setDateTimeStyles();
3. с помощью данного метода setDateTimePattern().

В качестве побочного эффекта этот метод переопределяет текущие стили времени и даты для данного объекта DateTimeFormatter и задает им значение DateTimeStyle.CUSTOM.

Строка шаблона определяет форматирование даты и времени. Шаблон содержит последовательности букв, которые заменяются на значения даты и времени в отформатированной строке. Например, в шаблоне «yyyy/MM» символы «yyyy» заменяются на четырехзначное представление года, после которого следует символ «/», а символы «MM» заменяются на двухзначное числовое представление месяца.

Многие буквы, используемые в шаблонах, могут неоднократно повторяться для определения разных строк, как показано в таблице ниже.

Если последовательность превышает максимальное число, поддерживаемое шаблоном, она заменяется на самую длинную поддерживаемую последовательность для данной буквы шаблона. Например:

• MMMMMM меняется на MMMM
• dddd меняется на dd
• EEEEEEE меняется на EEEE
• aa меняется на a
• hhh меняется на hh
• mmmm меняется на mm

Теоретически, шаблон может содержать до 225 символов, но на некоторых шаблонах это число меньше. Если шаблон превышает максимальный предел, свойству lastOperationStatus задается значение LastOperationStatus.PATTERN_SYNTAX_ERROR.

Операционная система может поддерживать не все возможные шаблоны. Если шаблон не поддерживается на платформе, используется резервный шаблон, а значение свойства lastOperationStatus указывает использование резервного варианта. Если в системе не предусмотрено резервного шаблона, отображается пустая строка, а свойство lastOperationStatus указывает, что данный шаблон не поддерживается.

В следующей таблице перечислены допустимые буквы шаблона и их значения.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

Устанавливает стили даты и времени для данного экземпляра DateTimeFormatter. Стили даты и времени служат для определения шаблонов форматирования даты и времени в соответствии с шаблонами, предварительно определенными для локали в операционной системе. Этот метод заменяет стили, заданные с помощью конструктора DateTimeFormatter() или метода setDateTimePattern(). Шаблон даты и времени также обновляется на основе заданных стилей.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

Связанные элементы API

В данном примере использованы следующие локали: английская (США), французская (Франция), испанская (Испания).

Для каждой локали в списке выполняются следующие действия.

1. Создается объект DateTimeFormatter с использованием стиля по умолчанию (long dateStyle, long timeStyle).
2. Форматирует текущую дату и время, используя длинный стиль даты.
3. Измените стиль даты на короткий, содержащий только время, с помощью констант DateTimeStyle.NONE и DateTimeStyle.SHORT.
4. Форматирует текущую дату и время, используя короткий стиль даты, содержащий только время.

package {
    import flash.display.Sprite;
    import flash.globalization.DateTimeFormatter;
    import flash.globalization.DateTimeStyle;
    
    public class DateTimeFormatterExample extends Sprite
    {    
        private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
    
        public function DateTimeFormatterExample()
        {
            var date:Date = new Date();
            
            for each (var locale:String in localeList) {
                var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
                trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName 
                    + "; actual=" + dtf.actualLocaleIDName);
            
                var longDate:String = dtf.format(date);
                trace(longDate + " (" + dtf.getDateTimePattern() + ")");
            
                dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
                var shortDate:String = dtf.format(date);
                trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
            }        
        }
    }
}

Для каждой локали в списке выполняются следующие действия.

1. Создается три текстовых поля ввода и вывода.
2. Создается объект DateTimeFormatter с использованием локали английского языка (США).
3. Вызывается функция configureTextField(), которая задает положение и размер текстовых полей, а также добавляется прослушиватель событий в объект patternField.
4. Когда пользователь вводит шаблон в текстовое поле patternField, функция textInputHandler форматирует с его помощью текущую дату и время и отображает результат и значение lastOperationStatus в текстовых полях вывода.

 
package {  
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.globalization.DateTimeFormatter;
    import flash.text.*;
    
    public class DateTimePatternExample extends Sprite
    {    
        private var patternField:TextField = new TextField();
        private var resultField:TextField = new TextField();
        private var statusField:TextField = new TextField();
           private var date:Date = new Date();
         private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");           
         
        private function configureTextField():void
        {
            patternField.type = TextFieldType.INPUT;
            patternField.width = 300;
            patternField.height = 20;
            patternField.background = true;
            patternField.border = true;
            
            resultField.y = 40;
            resultField.width = 300;
            resultField.height = 20;
            
            statusField.y = 80;
            statusField.width = 300;
            statusField.height = 20;

            addChild(patternField);
            addChild(resultField);
            addChild(statusField);
            patternField.addEventListener(Event.CHANGE,textInputHandler);
        }

        private function textInputHandler(event:Event):void
        {                 
            dtf.setDateTimePattern(patternField.text);
            statusField.text = dtf.lastOperationStatus;
            resultField.text = dtf.format(date);
        }

        public function DateTimePatternExample()
        {
            configureTextField();    
        }
    }
}